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Foreword 

This Technical Specification (TS) has been produced by the 3 rd Generation Partnership Project (3GPP). 

The present document is part 3 of a multi-part TS covering the 3 rd Generation Partnership Project: Technical 
Specification Group Services and System Aspects; Telecommunication Management; Configuration Management, as 
identified below: 

Part 1: "3G Configuration Management: Concept and Requirements"; 

Part 2: "Notification Integration Reference Point: Information Service Version 1"; 

Part 3: "Notification Integration Reference Point: CORBA Solution Set Version 1:1"; 

Part 4: "Notification Integration Reference Point: CMIP Solution Set Version 1:1"; 

Part 5: "Basic Configuration Management IRP Information Model (including NRM) Version 1"; 

Part 6: "Basic Configuration Management IRP CORBA Solution Set Version 1:1"; 

Part 7: "Basic Configuration Management IRP CMIP Solution Set Version 1:1"; 

Part 8: "Name Convention for Managed Objects". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality Of Service (QOS). The CM actions 
are initiated either as a single action on a NE of the 3G network or as part of a complex procedure involving actions on 
many NEs. 

The Itf-N interface for CM is built up by a number of Integration Reference Points (IRPs) and a related Name 
Convention, which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
ITU-T Recommendation X.736 [1] and OMG TC Document telecom [2]. For CM, a number of IRPs (and the Name 
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Convention) are defined herein, used by this as well as other specifications for Telecom Management (TM) produced 
by 3GPP. All these are included in 3GPP TS 32.106 from Part 2 and onwards. 

The present document is Part 3 of 3GPP TS 32.106 (3GPP TS 32.106-3) - Notification IRP CORBA Solution Set. 

IRP Solution Set version: The version of this CORBA Solution Set is 1:1, where the first "1" means that it 
corresponds to the Information Service (3GPP TS 32.106-2 [5]) version 1, and the second "1" means that it is the first 
CORBA Solution Set corresponding to this Information Service version. 
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1 Scope 



The present document specifies the Common Object Request Broker Architecture (CORBA) Solution Set (SS) for the 
IRP whose semantics is specified in Notification IRP: Information Service (3GPP TS 32.106-2 [5]). 



References 



The following documents contain provisions, which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. 

[I] ITU-T Recommendation X.736: "Security Alarm Reporting Function". 

[2] OMG TC Document telecom (98-1 1-01): "OMG Notification Service". 

[3] OMG CORBA services: Common Object Services Specification, Update: November 22, 1996. 

(Clause 4 contains the Event Service Specification.) 

[4] 3GPP TS 32.106-8: "Name Convention for Managed Objects". 

[5] 3GPP TS 32.106-2: "Notification IRP: Information Service". 

[6] 3GPP TS 32.1 1 1-2: "Alarm IRP: Information Service". 

[7] 3GPP TS 32.111-3: "Alarm IRP: CORBA Solution Set, version 1:1". 

[8] ITU-T Recommendation X.733: "Alarm Reporting function". 

[9] 3GPP TS 32.101 : "3G Telecom Management principles and high level requirements". 

[10] 3GPP TS 32.102: "3G Telecom Management architecture". 

[II] 3GPP TS 32.106-1 : "3G Configuration Management: Concept and Requirements". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: Please refer to 3GPP TS 32.101 
[9], 3GPPTS 32.102 [10] and3GPPTS 32.106-1 [11]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture (OMG) 

EC Event channel (OMG) 

IDL Interface Definition Language (OMG) 

IS Information Service 
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NC Notification Channel (OMG) 

NE Network Element 

NV Name and Value pair 

EM Element Manager 

OMG Object Management Group 

SS Solution Set 

UML Unified Modelling Language (OMG) 



Architectural features 



The overall architectural feature of Notification IRP is specified in 3GPP TS 32.106-2 [5]. This clause specifies 
features that are specific to the CORBA Solution Set (SS). 

4.1 Notification services 

In the CORBA Solution Set, notifications are emitted by IRP Agent using CORBA Notification service (OMG TC 
Document telecom [2]). 

CORBA Event service (OMG CORBA services [3]) provides event routing and distribution capabilities. CORBA 
Notification service provides, in addition to Event service, event filtering and support for Quality Of Service (QOS) as 
well. 

A subset of CORBA Notification services shall be used to support the implementation of notification. This CORBA 
Notification service subset, in terms of OMG Notification service (OMG TC Document telecom [2]) defined methods, 
is identified in the present. 

4.1 .1 Support of Push and Pull Interface 

The IRP Agent shall support the OMG Notification push interface model. Additionally, it may support the OMG 
Notification pull interface model as well. 

4.1 .2 Support of multiple notifications in one push operation 

For efficiency, IRP Agent uses the following OMG Notification Service (OMG TC Document telecom [2]) defined 
interface to pack multiple notifications and push them to IRPManager using one method 

push_structured_event s. The method takes as input a parameter of type Event Batch as defined in the OMG 
CosNot if icat ion module (OMG TC Document telecom [2]). This data type is a sequence of Structured Events 
(see clause 4). Upon invocation, this parameter will contain a sequence of Structured Events being delivered to 
IRPManager by IRP Agent to which it is connected. 

The maximum number of events that will be transmitted within a single invocation of this operation is controlled by 
IRP Agent wide configuration parameter. The amount of time IRP Agent will accumulate individual events into the 
sequence before invoking this operation is controlled by IRP Agent wide configuration parameter as well. 

IRP Agent may push Event Batch with only one Structured Event. 

The OMG Notification service (OMG TC Document telecom [2]) defined IDL module is shown below. 

module CosNot if yComm { 

Interface SequencePushConsumer : Notif yPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises ( CosEventComm: : Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 
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5 Mapping 

5.1 Operation mapping 

Notification IRP: IS (3GPP TS 32.106-2 [5]) defines semantics of operations visible across this IRP. 

Table 1 maps the operations defined in Notification IRP: IS (3GPP TS 32.106-2 [5]) to their equivalents (methods) in 
this Solution Set (SS). It also qualifies if a method is Mandatory (M) or Optional (O) 



Table 1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 


SS Methods 


Qualifier 


3GPPTS 32.106-2 [5] 






subscribe 


attach_push, attach_push_b, attach_pull 


M, O, O 


unsubscribe 


detach 


M 


get Notification 
IRPVersion 


get_notif ication_IRP_version 


M 


get Subscription 
Status 


get_subscription_status 


O 


get Sub script ion Ids 


get_subscription_ids 


O 


change 

Subscription 

Filter 


If subscription is established using att ach_push method, the SS 
equivalent shall be change_subscription_f ilter . The IDL 
specification of this method is included in Annex A. This method is 
Optional (O). 

If subscription is established using att ach_push_b method, the SS 
equivalent shall be modif y_constraint s. The method is defined in 
OMG Notification Service Filter Interface (OMG TC Document telecom 
[2]). The IDL specification of this method is not included in Annex A. 
If IRP Agent supports the optional attach_push_b method, it shall 
support this method as mandatory. 

If subscription is established using attach_pull method, the SS 
equivalent shall be modif y_constraints. The method is defined 
by OMG Notification Service Filter Interface (OMG TC Document 
telecom [2]). The IDL specification of this method is not included in 
Annex A. If IRP Agent supports the optional attach_pull method, it 
shall support this method as mandatory. 


See box on 
the left. 


suspend 
Subscription 


If subscription is established using att ach_push, there is no SS 
equivalent. In other words, IRPManager cannot suspend subscription. 

If subscription is established using att ach_push_b, the SS 
equivalent shall be suspen d_c onnection. This method is 
defined by OMG Notification Service (OMG TC Document telecom 
[2]). The IDL specification of this method is not included in Annex A. 
If IRP Agent supports the optional attach_push_b method, it shall 
support this method as mandatory. 

If subscription is established using attach_pull, there is no SS 
equivalent. 


See box on 
the left 
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resume 
Subscription 


If subscription is established using att ach_push, there is no SS 
equivalent. In other words, IRPManager cannot resume subscription. 

If subscription is established using att ach_push_b, the SS 
equivalent shall be resume_connection . This method is defined 
by OMG Notification Service (OMG TC Document telecom [2]). The 
IDL specification of this method is not included in Annex A. If 
IRP Agent supports the optional attach_push_b method, it shall 
support this method as mandatory. 

If subscription is established using attach_pull, there is no SS 
equivalent. 


See box on 
the left 


get Notification 
Categories 


get_notif ication_categories 


O 



5.2 Operation parameter mapping 

3GPP TS 32.106-2 [5] defines semantics of parameters carried in operations across the Notification IRP. Table 2 
through table 12 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS subscribe parameters to SS attach_push equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Re f erence 


Object manager_ref erence 


M 


timeTick 


long time_tick 


O 


notification 
Categories 


Notif icationlRPConstDef s : :Notif icationCategorySet 
not if ication_category_set 


O 


filter 


string filter (See NOTE) 


O 


sub script ion Id 


Return value of type Subscriptionld 


M 


status 


Attach, ParameterNotSupported, InvalidParameter, 

Already Sub scribed, 

At Lea stOneNotif icationCategoryNot Supported 


M 


NOTE: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document 
telecom [2]). This grammar shall be the only one used for Alarm IRP: CORBA SS. 



Table 3: Mapping from IS subscribe parameters to SS attach_push_b equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Re f erence 


Object manager_ref erence 


M 


timeTick 


long time_tick 


O 


notification 
Categories 


Notif icationlRPConstDef s : :Notif icationCategorySet 
notif ication_category_set 


O 


filter 


string filter 


O 


subscriptionld 


Return value of type Subscriptionld 


M 


Not specified in IS 


CosNotif y Channel Admin : : SequenceProxyPushSupplier 
system_ref erence (See NOTE) 


M 


status 


Attach, OperationNotSupported, 
ParameterNotSupported, InvalidParameter, 
Already Sub scribed, 
At Leas tOneNot if icationCategoryNot Supported 


M 


NOTE: IRPAgent provides this reference to which IRPManager can invoke methods to manage the subscription. 

Valid methods are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read 

interface SequencePushSupplier iproxySupplier, CosNotif yComm: : SequencePushSupplier{}. 

IRPManager is expected to invoke connect_sequence_push_consumer ( ) of this interface to connect its 
own cosNotif yComm::sequencePushConsummer with this reference. After successful connection, 
IRPAgent pushes sequence of Structured Events towards IRPManager. 
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Table 4: Mapping from IS subscribe parameters to SS attach_pull equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Re f erence 


Object manager_ref erence 


M 


timeTick 


long time_tick 


O 


notification 
Categories 


Notif icationlRPConstDef s : :Notif icationCategorySet 
not if ication_category_set 


O 


filter 


string filter 


O 


sub script ion Id 


Return value of type Subscriptionld 


M 


Not specified in IS. 


CosNotif y Channel Admin : : SequenceProxyPullSupplier 
system_ref erence 


M 


status 


Attach, OperationNotSupported, 
ParameterNot Supported, InvalidParameter, 
Already Sub scribed, 
At Lea stOneNotif icationCategoryNot Supported 


M 



Table 5: Mapping from IS unsubscribe parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Re f erence 


Object manager_ref erence 


M 


subscriptionld 


string subscription_id 


O 


status 


Detach, InvalidParameter 


M 



Table 6: Mapping from IS getNotif icationiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumber 
List 


Return value of type CommonlRPConstDef s : : VersionNumberSet 


M 


status 


GetNotif icationiRPVersion 


M 



Table 7: Mapping from IS getsubscriptionstatus parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionld 


string subscription_id 


M 


notification 
CategoryList 


Return value of type 

Notif icationlRPConstDef s : :Notif icationCategorySet 


M 


f ilterlnEf feet 


string f ilter_in_ef f ect 


O 


subscription 
State 


Notif icationlRPConstDef : : SubscriptionState 
subscription_state 


O 


timeTick 


long time_tick 


O 


status 


GetSubscriptionStatus, OperationNotSupported, InvalidP 
arameter 


M 



Table 8: Mapping from IS getsubscriptionids parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Re f erence 


Object manager_ref erence 


M 


subscriptionldList 


Return value of type 

Notif icationlRPConstDef s : : SubscriptionldSet 


M 


status 


GetSubscriptionlds, OperationNotSupported, InvalidPara 
meter 


M 



Table 9: Mapping from IS changeSubscriptionFilter parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionld 


string subscription_id 


M 


filter 


string filter 


M 


status 


ChangeSubscriptionFilter, OperationNotSupported, Inval 
idParameter 


M 
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Table 10: Mapping from IS suspendSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sub script ion Id 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and requires no parameter. Therefore, there 

is no SS equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and it returns a void. Therefore, there is no 

SS equivalent for this IS parameter. This suspend_connection method can 

raise OMG Notification Service (OMG TC Document telecom [2]) defined 

exception called Connect ionAlready Inactive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 11 : Mapping from IS resumeSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


sub script ion Id 


If subscription is established using att ach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connect ion. This method is defined by OMG Notification 

Service (OMG TC Document telecom [2]) and requires no parameter. 

Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using att ach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using att ach_push_b, the SS equivalent 

method is resume_connect ion. This method is defined by OMG 

Notification Service (OMG TC Document telecom [2]) and returns a void. 

Therefore, there is no SS equivalent for this IS parameter. This 

resume_connect ion method can raise OMG Notification Service (OMG 

TC Document telecom [2]) defined exception called 

Connect ionAlreadyActive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 12: Mapping from IS getNotificationCategories parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


notification 
CategoryList 


Return value of type 

Notif icationlRPConstDef s : :Notif icationCategorySet 


M 


event TypeLi st 


Notif icationlRPConstDef s : : EventTypesSet 
event_type_list 


O 


extendedEvent 
TypeList 


Notif icationlRPConstDef s : : ExtendedEventTypesSet 
extended_event_type_list 


O 


status 


GetNotificationCategories, Ope rat ionNot Supported 


M 
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5.3 Notification parameter mapping 



Notification IRP: IS (3GPP TS 32.106-2 [5]) defines a generic notify and its parameters. This SS does not provide 
the mapping of these parameters to their CORBA SS equivalents. 

Other IRPs using the Notification IRP such as Alarm IRP: IS (3GPP TS 32.111-2 [6]) extend the generic notify for their 
specific use. Their corresponding SS documents shall define the mapping from their specific notification parameters 
(defined in their IS document) to their SS equivalents. These SS documents shall qualify their SS equivalents as well. 



5.4 Attribute mapping 



Notification IRP: IS (3GPP TS 32.106-2 [5]) defines the semantics of common attributes carried in notifications. This 
SS does not provide the mapping of these attributes to their CORBA SS equivalents. Other IRPs such as Alarm IRP: 
IS (3GPP TS 32.111-2 [6]) identify and qualify these common attributes for use in their environment. Their 
corresponding SS documents define the mapping of these attributes to their SS equivalents. 



6 Use of OMG Notification structuredEvent 

Notification IRP: IS (3GPP TS 32.106-2 [5]) defines attributes that are commonly present in notifications of all 
notification categories such as notifications emitted from Alarm IRP IRP Agent. 

In CORBA SS, OMG defined StructuredEvent (OMG TC Document telecom [2]) is used to carry notification. 
This clause identifies the OMG defined StructuredEvent attributes that carry the common attributes defined in 
3GPPTS 32.106-2 [5]. 

The composition of OMG StructuredEvent is: 

Header 

Fixed Header 

D oma i n_n ame 
Type_name 
Event_name 
Variable Header 
Body 

Filterable_body_f ields 
Remaining_body 
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Table 13 shows the OMG Structured Event attributes (middle column) that are used to carry the common notification 
attributes defined in Notification IRP: IS (3GPP TS 32. 106-2 [5]). 

Table 13: Attributes of structuredEvent 



Common 

attributes defined 

in Notification 

IRP: IS 

(3GPPTS 32.106- 

2 [5]) 


Attribute 

defined by 

OMG 

Structured 
Event 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 


It indicates that the StructuredEvent, carried in the Notification, is defined by 
a specific 3 GPP IRP such as Alarm IRP, as opposed to OMG specified 
Telecommunication, healthcare, utility, finance, etc. It indicates the CORBA SS 
version number as well. 

It is a string. Legal values are defined in module. 

For Alarm IRP version 1:1, the value is ALARM_IRP_VERSION_l_l. 


eventType 


type_name 


It indicates event types of this notification. The semantics of the event type is 
defined by ITU-T TMN Recommendations. Each IRP, such as Alarm IRP IS 
version 1, shall identify the ITU-T defined event types for their use. Each such IRP 
document shall define the values of the identified event Types as well. 

Dependent on the notification category, possible legal values are: 

COMMUNICATIONS_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
QUALITY_OF_SERVICE_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
PROCESSING_ERROR_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
EQUIPMENT_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
ENVIRONMENTAL_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
PHYSICAL_VIOLATION (ITU-T Recommendation X.736 [1]), 
INTEGRITY_VIOLATION (ITU-T Recommendation X.736 [1]), 
SECURITY_VIOLATION (ITU-T Recommendation X.736 [1]), 
TIME_DOMAIN_VIOLATION (ITU-T Recommendation X.736 [1]), 
OPERATIONAL_VIOLATION (ITU-T Recommendation X.736 [1]). 

The bracketed number of each type indicates the reference where the semantics of 
the type is specified. 

It is a string. See each individual CORBA SS IDL module for each IRP using the 
Notification IRP, for legal values used by that IRP version. 

Since each IRP except Notification IRP specifies its own set of event type, the 
values specified by each IRP are only unique within one IRP. For uniqueness 
among all IRPs' specifications, the values of event type shall be coupled with the 
notification category, the value carried in domain_name of the same notification. 


extended 
EventType 


event_name 


The legal values carried in this attribute are specified by the IRP using the 
notification. For example, Alarm IRP: CORBA SS (3GPP TS 32.111-3 [7]) defines 
and uses the following values: 

NOTIFY_FM_NEW_ALARM, 
NOTIFY_FM_CHANGED_ALARM, 
NOTIFY_FM_ACK_STATE_CHANGED, 
NOTIFY_FM_CLEARED_ALARM and 
NOTIFY_FM_ALARM_LIST_REBUILT. 

It is a string. See each individual CORBA SS IDL module for each IRP using the 
Notification IRP, for legal values used by that IRP version. 

Since each IRP except Notification IRP specifies its own set of extended event 
type, the values specified by each IRP are only unique within one IRP. For 
uniqueness among all IRPs' specification, the values of extended event type shall 
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be coupled with the notification category, the value carried in domain_name of 
the same notification. 


There is no 
corresponding SS 
attribute. 


variable 
Header 




managed 

Object 

Class, 

managed 

Object 

Instance 


OneNV 
(name-value) 
pair of 

f ilterable_ 
body_f ields 


Name of NV pair is a string, NV_MANAGED_OB JECT_INSTANCE. 

Value of NV pair is a string. Syntax and semantics of this string conform to the 

Managed Object string representation specified in (3GPP TS 32.106-8 [4]). Note 

that two SS attributes are carried in this one NV pair since the string representation 

specified in 3GPP TS 32.106-8 [4] can convey the semantics of 

managedOb jectClass and managedOb ject Instance in one string. 


notification 
Id 


One NV pair of 

f ilterable_ 
body_f ields 


Name of NV pair is a string, NV_NOTIFICATION_ID. 
Value of NV pair is an unsigned long. 


eventTime 


One NV pair of 

f ilterable_ 
body_f ields 


Name of NV pair is a string, NV_EVENT_TIME. 
Value of NV pair is an IRPTime. 


systemDN 


One NV pair of 

f ilterable_ 
body_f ields 


Name of NV pair is a string, NV_SYSTEM_DN. 

Value of NV pair is a string. Syntax and semantics of this string conforms to the 

Managed Object string representation specified in 3GPP TS 32.106-8 [4]. 


There is no 
corresponding SS 
attribute. 


remaining_ 
Body 
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7 IRPAgent's Behaviour 

This clause describes some IRPAgent's behaviour not captured by IDL. 

7.1 Subscription 

IRPManager can invoke multiple a 1 1 a c h_p ush, multiple a 1 1 a c h_p u s h_b or multiple a 1 1 a c h_p u 1 1 using 
different manage r_ref erence(s). As far as IRP Agent is concerned, the IRP Agent will emit notifications to 
multiple "places" with their independent filter requirements. IRP Agent will not know if the notifications are going to 
the same IRPManager. 

If IRPManager invokes multiple a 1 1 a c h_p ush, attac h_p u s h_b or a 1 1 a c h_p u 1 1 using the same 
manager_ref erence and with an already subscribed notif ication_category, IRP Agent shall raise 
Already Sub scribed exception to all invocations except one. 

IRPManager can invoke multiple attach_push using the same manager_ref erence and with one or more not- 
yet-subscribed notif ication_categories. In this case, if IRP Agent supports all the notification categories 
requested, IRP Agent shall accept the invocation; otherwise, it raises 
AtLeastOneNotif icationCategoryNotSupported exception. IRP Agent shall have similar behaviour for 

attach_push_b and attach_pull. 

When IRPManager is in subscription by invoking attach_push, IRPManager can change the filter constraint, using 
change_subscription_f ilter, applicable to the notification categories specified in the attach_push. 

When IRPManager is in subscription by invoking attach_push_b, IRPManager can change the filter constraint 
during subscription using the OMG defined Notification Service Filter Interface. IRPManager shall not use 
change_subscription_f ilter; otherwise it shall get an exception. 

7.2 IRPAgent supports multiple categories of Notifications 

IRP Agent may emit multiple categories of Notifications. IRPAgent may have mechanism for IRPManager to pull for 
notifications of multiple categories. 

IRPManager can query IRPAgent about the categories of notifications supported by using 

get_notif ication_categories. 

IRPManager uses a parameter, notif ication_categories, in attach_push, attach_push_b and 
attach_pull to specify one or more categories of notifications wanted. 

IRPManager uses a zero-length sequence in notif ication_categories of attach_push, attach_push_b 
and attach_pull to specify that all IRPAgent supported categories of notifications are wanted. If IRPManager uses 
attach_push with zero-length sequence in notif icat ion_categories and if the operation is successful, 
IRPAgent shall reject subsequent attach_push operation, regardless if the notif ication_categories 
contains a zero-length sequence or one or more specific notification categories. IRPAgent shall have similar behaviour 
for attach_push_b and attach_pull. 

7.3 IRPAgent's integrity risk of attach_push_b Method 

In the case that IRPAgent implements this method by extending or using OMG compliant Notification Service, the 
following IRPManager behaviour illustrates a risk to IRPAgent's integrity. 

Given the object reference (IOR) of the SequenceProxyPushSupplier (as the mandatory output parameter of the 
subject method), IRPManager can invoke sequenceProxyPushSupplier.MyAdmin method. 

IRPManager can then obtain the consumer admin object of the proxy. Then IRPManager can invoke 
consumerAdmin.MyChannel to get the IOR of the Notification Channel. IRPManager then can call 
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event Channel .MyFactory which will provide IRPManager the IOR of the Event ChannelFactory itself. 
IRPManager can then able to invoke methods directly on the EventChannelFactory, like get_all_channels 
which lists all channel numbers and create_channel which allows IRPManager to create any number of additional 
channels. 

A malicious IRPManager can, given access to the EventChannelFactory, get a list of existing channels and start 
connecting them together at random thus compromising the IRP Agent's integrity. Deployment of this 
attach_push_b needs strong authentication and authorisation mechanism in place. 

attach_push is mandatory. IRP Agent compliant to this IRP shall implement it. 

attach_push_b is optional. It is recommended that IRP Agent concerned with integrity risk should not implement 
the attach_push_b option. 



8 Example of Notification related to alarm 

The following is an example of Notification related to alarm. 

If type_name == NOTIFY_FM_NEW_ ALARM, then the f ilterable_body_f ield attributes can contain: 

{ 

systemDN, "..."; 
alarmld, "abce232", 

notif icationld, 4467, 
managedOb jectlnstance, "...", 

eventTime, ..., 
probableCause, 3, 
perceivedSeverity, 2, 
specif icProblems, "xxx", 
additionalText, "...", 
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Annex A (normative): 
Notification IRP CORBA IDL 



/* ## Module: CommonlRPConstDef s 

This module contains definitions commonly used among all IRPs such as Alarm IRP. 

*/ 

#ifndef CommonlRPConstDef s_idl 
#define CommonlRPConstDef s_idl 
#include <TimeBase . idl> 
#pragma prefix "3gppsa5.org" 

module CommonlRPConstDef s { 

/* 

Definition imported from CosTime. The time refers to time in Greenwich 
Time Zone. It also consists of a time displacement factor in the form 
of minutes of displacement from the Greenwich Meridian. 

*/ 

typedef TimeBase : :UtcT IRPTime; 

enum Signal {OK, Failure, PartialFailure } ; 
typedef sequence <string> VersionNumberSet ; 

}; 
#endif 



/* ## Module: Notif icationlRPConstDef s 

This module contains definitions specific to Notification IRP. 

*/ 

#ifndef Notif icationlRPConstDef s_idl 
#def ine Notif icationlRPConstDef s_idl 
#pragma prefix "3gppsa5.org" 

module Notif icationlRPConstDef s { 

/* 

This is a string sequence identifying notification categories. 

A notification category is identified by the IRP name and its version. 

*/ 

typedef sequence <string> Notif icationCategorySet ; 

/* 

This is a sequence of strings identifying event types of a particular 
notification category. 

*/ 

typedef sequence <string> EventTypesPerNotif icationCategory; 

/* 

This sequence identifies all event types of all notification categories 
identified by Notif icationCategorySet . The number of elements in this 
sequence shall be identical to that of Notif icationCategorySet . 
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*/ 

typedef sequence <EventTypesPerNotif icationCategory> EventTypesSet ; 

/* 

This is a sequence of strings identifying extended event types of 
a particular notification category. 

*/ 

typedef sequence <string> ExtendedEventTypePerNotif icationCategory; 

/* 

This sequence identifies all extended event types of all notification 
categories identified by Notif icationCategorySet . The number of elements 
in this sequence shall be identical to that of Notif icationCategorySet . 

*/ 

typedef sequence <ExtendedEventTypePerNotif icationCategory> 
Ext endedE vent Types Set; 

typedef sequence <long> Notif IDSetType; 

/* 

This holds identifiers of notifications that are correlated. 
*/ 

struct CorrelatedNotif ication { 

string source; // Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero-length string. In this case, the MO 
// is identified by the value of the MOI parameter-attribute 
// of the Structured Event, i.e., the notification. 
NotiflDSetType notiflDSet; 

}; 

/* 

Correlated Notification sets are sets of Correlated Notification 

structures . 

*/ 

typedef sequence <CorrelatedNotif ication> CorrelatedNotif icationSetType; 

/* 

This is a sequence of strings identifying Subscription Ids. 

*/ 

typedef string Subscriptionld; 

typedef sequence <SubscriptionId> SubscriptionldSet ; 

/* 

This block encapsulates valid strings carried in domain_name of 
structured event header. It carries the name of IRP and its 
corresponding CORBA SS version number. They are the returned 
values for get_XXX_IRP_version ( ) as well. 

*/ 

const string ALARM_IRP_VERSION_l_l = "lfl"; //alarm IRP 1:1 
const string CONFIGURATION_IRP_VERSION_l_l = "lcl"; //CM IRP 1:1 

/* 

This string is used as return value for get_notif ication_irp_version ( ) 

*/ 

const string NOTIFICATION_IRP_VERSION_l_l = "lnl"; //Notification IRP 1:1 
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/* 

This block encapsulates string used in the name of the Name Value 

pair of the structured event. 

*/ 

const string NV_NOTIFICATION_ID = "a"; 

const string NV_CORRELATED_NOTIFICATIONS = "b"; 

const string NV_EVENT_TIME = "c"; 

const string NV_SYSTEM_DN = "d"; 

const string NV_MANAGED_OBJECT_CLASS = "e"; 

const string NV_MANAGED_OBJECT_INSTANCE = "f"; 



II U II 



const string NV_PERCEIVED_SEVERITY - "h 
const string NV_SPECIFIC_PROBLEM 



ii -; ii , 



II o " 



const string NV_ALARM_ID = "k"; 

const string NV_ACK_USER_ID = "1"; 

const string NV_ACK_TIME = "m"; 

const string NV_ACK_SYSTEM_ID = "n"; 

const string NV_ACK_STATE = "o"; 

const string NV_BACKED_UP_STATUS = f 

const string NV_BACK_UP_OBJECT = "q f 

const string NV_THRESHOLD_INFO = "r ! 

const string NV_TREND_INDICATION 

const string NV_STATE_CHANGE_DEFINITION 

const string NV_MONI TORE D_AT TRIBUTES = '' 

const string NV_PROPOSED_REPAIR_ACTIONS 



/* 

This indicates if the subscription is active (not suspended) or inactive. 

*/ 

enum SubscriptionState {Inactive, Active, DontKnow}; 



}; 
#endif 



/* ## Module: Notif icationlRPSystem 

This module implements capabilities of IRPAgent specified in Notification 
IRP : Information Service version 1 and its equivalents in Notification 
IRP: CORBA Solution Set version 1:1. 

*/ 

#ifndef Notif icat ion IRP System_idl 
#def ine Notif icat ion IRP System_idl 

#include "CosNotifyComm. idl" 
#include "CosNotif yChannelAdmin . idl" 
#include "Notif icationlRPConstDefs . idl" 
#include "CommonlRPConstDef s . idl" 
#pragma prefix "3gppsa5.org" 



module Notif icationlRPSystem { 

/* 

System fails to complete the operation. System can provide reason 
to qualify the exception. The semantics carried in reason 
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is outside the scope of this IRP . 
*/ 

exception Attach { string reason; }; 
exception DetachException { string reason; }; 

exception GetSubscriptionStatus { string reason; }; 
exception GetSubscriptionlds { string reason; }; 
exception ChangeSubscriptionFilter { string reason; }; 
exception GetNotif icationCategories { string reason; }; 
exception GetNotif icationlRPVersion { string reason; }; 

exception ParameterNotSupported { string parameter; }; 

// name of the unsupported parameter as defined in IDL 

exception InvalidParameter { string parameter; }; 

// name of the parameter as defined in IDL 

exception OperationNotSupported {}; 

exception AlreadySubscribed {}; 

exception AtLeastOneNotif icationCategoryNotSupported {}; 

interface Notif icationlRPOperations { 

/* ## Operation: attach_push 

*/ 

Notif icationlRPConstDef s :: Subscriptionld attach_push ( 

in Object manager_ref erence, 

in long time_tick, 

in Notif icationlRPConstDef s : :Notif icationCategorySet 
notif ication_category_set , 

in string filter 
) 

raises (Attach, ParameterNotSupported, InvalidParameter, AlreadySubscribed, 
AtLeastOneNotif icationCategoryNotSupported) ; 

/* ## Operation: attach_push_b 
*/ 

Notif icationlRPConstDef s :: Subscriptionld attach_push_b ( 
in Object manager_ref erence, 
in long time_tick, 
in Notif icationlRPConstDef s : :Notif icationCategorySet 

notif ication_category_set, 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPushSupplier system_ref erence 
) 

raises 
(Attach, OperationNotSupported, ParameterNotSupported, InvalidParameter, AlreadySubs 
cribed, AtLeastOneNotif icationCategoryNotSupported) ; 

/* ## Operation: attach_pull 

*/ 

Notif icationlRPConstDef s :: Subscriptionld attach_pull ( 

in Object manager_ref erence, 

in long time_tick, 

in Notif icationlRPConstDef s : :Notif icationCategorySet 
notif ication_category_set, 

in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPullSupplier system_ref erence 
) 

raises (Attach, OperationNotSupported, ParameterNotSupported, 
InvalidParameter, AlreadySubscribed, 
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At Lea stOneNotif icationCategoryNot Supported) ; 

/* ## Operation: detach 
*/ 
void detach ( 

in Object manager_ref erence, 

in string subscription_id 
) 
raises (DetachException, InvalidParameter) ; 

/* ## Operation: get_notif ication_IRP_version 

*/ 

Common I RP Con stDef s : : VersionNumberSet get_notif ication_IRP_version () 

raises (GetNotif icationlRPVersion) ; 

r 

/ '* ## Operation: get_subscription_status 

*/ 

Notif icationlRPConstDef s : :Notif icationCategorySet get_subscription_status ( 

in string subscription_id, 

out string f ilter_in_ef f ect , 

out Notif icationlRPConstDef s : : SubscriptionState subscription_state, 

out long time_tick 
) 
raises (GetSubscriptionStatus , OperationNotSupported, InvalidParameter) ; 

/* ## Operation: get_subscription_ids 

*/ 

Notif icationlRPConstDef s : : SubscriptionldSet get_subscription_ids ( 
in Object manager_ref erence 

) 

raises (GetSubscriptionlds , OperationNotSupported, InvalidParameter) ; 

/* ## Operation: change_subscription_f ilter 

*/ 

void change_subscription_f ilter ( 

in string subscription_id, 

in string filter 
) 
raises (ChangeSubscriptionFilter , OperationNotSupported, InvalidParameter) ; 

/* ## Operation: get_notif ication_categories 

*/ 

Notif icationlRPConstDef s : :Notif icationCategorySet 
get_notif ication_categories ( 
out Notif icationlRPConstDef s :: EventTypesSet event_type_list , 
out Notif icationlRPConstDef s : : ExtendedEventTypesSet 
extended_event_type_list 
) 
raises (GetNotif icationCategories, OperationNotSupported) ; 

}; 
}; 
#endif 
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Change history 



Change history 


TSG SA# 


Version 


CR 


Tdoc SA 


New 
Version 


Subject/Comment 


S 07 


2.0.0 


- 


SP-000012 


3.0.0 


Approved at TSG SA #7 and placed under Change Control 


Mar 2000 


3.0.0 






3.0.1 


cosmetic 


S_08 


3.0.1 


003 


SP-000243 


3.1.0 


Split of TS - Part 3: Notification Integration Reference Point (IRP): 
CORBA Solution Set (SS) 


S 10 


3.1.0 


001 R1 


SP-000519 


3.2.0 


Add pragma statement to Notification IRP IDL 


S_10 


3.1.0 


002 


SP-000519 


3.2.0 


Correction of IDL Errors 


S 10 


3.1.0 


003 


SP-000519 


3.2.0 


Spelling Errors in the CORBA IDL 


S 10 


3.1.0 


004 


SP-000519 


3.2.0 


Ensure consistency with IDL exception 



























ETSI 



3GPP TS 32.106-3 version 3.2.0 Release 1999 



23 



ETSI TS 132 106-3 V3.2.0 (2000-12) 



History 



Document history 


V3.1.0 


July 2000 


Publication 


V3.2.0 


December 2000 


Publication 





















ETSI 



